FastAPI 포트 번호 변경 실행 방법 정리 | ✅ 편저: 코담 운영자

🚀 FastAPI 포트 번호 변경 실행 방법 정리

FastAPI 애플리케이션을 개발하거나 배포할 때, 기본 포트(8000번) 이외의 사용자 지정 포트로 실행하는 방법을 정리했습니다.

---

✅ 기본 실행 명령어

uvicorn main:app --reload

• main: FastAPI 애플리케이션이 정의된 파이썬 파일 이름 (main.py)
• app: FastAPI 인스턴스 객체명
• --reload: 코드 수정 시 자동 재시작 (개발용)

---

✅ 포트 번호 변경하여 실행하기

🔹 예: 8080 포트에서 실행하고 싶다면

uvicorn main:app --reload --port 8080

• --port 옵션 뒤에 원하는 포트 번호 지정

🔹 결과

Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)

웹 브라우저에서 http://localhost:8080 또는 http://127.0.0.1:8080 으로 접속 가능

---

✅ 전체 예시 코드

main.py:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello, FastAPI!"}

터미널 실행:

uvicorn main:app --reload --port 8080

---

🧠 보너스: IP 주소 변경 (--host 옵션)

• 외부에서 접근하거나, 같은 네트워크 내 다른 장치에서 접속하려면:

uvicorn main:app --reload --host 0.0.0.0 --port 8080

• 그러면 다른 컴퓨터/스마트폰에서 아래와 같이 접속 가능:

http://<로컬IP주소>:8080

예: http://192.168.0.15:8080

---

✅ 요약

목적	명령어 예시
기본 실행	uvicorn main:app --reload
포트 번호 변경	uvicorn main:app --reload --port 8080
외부 접속 허용 (로컬 IP 공개)	uvicorn main:app --reload --host 0.0.0.0 --port 8080

개발 단계나 배포 환경에 따라 포트 번호를 유연하게 조절하세요!